Yahoo! JAPAN Ads API | Developer Center

2023/06/13

Yahoo! JAPAN Ads API v11 released

We have released the new version of Yahoo! JAPAN Ads API. Please see the following details.

Products

Yahoo! JAPAN Ads Search Ads API
Yahoo! JAPAN Ads Display Ads API

Version released

v11

Date

June 12, 2023 (Mon)

Changes on Search Ads API

■Change on reporting item name
We have changed the field names to unify the names of report items in Yahoo! Japan Ads Search Ads API and Yahoo! JAPAN Ads Display Ads API.

■ConversionTrackerService analytics acquisition specification changes
In the ConversionTrackerService, the analytics were returned by get, add, and set, but we have changed the specification to return only get.

■Remove some character codes in the history file
Removed character codes "UTF16LE" from the encoding format of the history file.

■Remove services that are no longer available
Removed services that are no longer available from the interface.

Changes on Display Ads API

■Interface changes to improve recommendations
The interface has been changed to improve the features of recommendations. The versions before v10 are also changed. See the following announcement for details of the improvements.
Display Ads (Auction) Change the frequency of updating your images and video ads in the recommendations

■ConversionTrackerService analytics acquisition specification changes
In the ConversionTrackerService, the analytics were returned by get, add, and set, but we have changed the specification to return only get.

■Extend the reporting period of the performance data
The reporting period will expand to the last 37 months from the last 25 months for performance data. It will be available on June 21, 2023 (Wed). See the following announcement for details.
Display Ads Longer reporting period for performance data

■Reports of the content keyword targeting
Creating reports for content keyword targeting is available.

■Add the enhanced CPC of the bid strategy
Supported "Enhanced CPC (eCPC) of a beta version in the bid strategy.

■Remove the destination URL field
Removed the destination URL field because ads with the destination URLs are no longer available after November 2022.

■Change on reporting item name
We have changed the field names to unify the names of report items in Yahoo! Japan Ads Search Ads API and Yahoo! JAPAN Ads Display Ads API. The existing fields are still available but will be discontinued. Use the new fields.

■Remove unavailable bid strategy
Removed unavailable bid strategies "AUTO" and "NONE."

■Support for specifying character encoding for history files
When creating a history file, specifying the character encoding became available.

■Maintenance release

• Support narrowing searches by AdType
  Added adTypes to AdGroupAdService(get) and GuaranteedAdGroupAdService(get) requests.

• Removed ad type information from placement list URL suggestions
  Removed AdFormat from the PlacementUrlIdeaService request and response.

The release of a Client Library for Java users

■Summary
We will release the v11 version of the Yahoo! JAPAN Ads API Client Library for Java users, supporting Spring Framework series 5 and 6. Spring boot 3 is also supported, so select a client library that is compatible with Spring Framework 5 or 6 depending on your operating environment. Each release tag of the library and its operating environment are as follows:

*If you want to keep the existing operating environment, use "5.0.0-spring5." You can continue to use the client library without changing the Java version or dependencies.
*Versions with "-spring5" such as "5.0.0-spring5" will not be supported after a certain time period. If you want to use these versions, migrate to a version without "-spring5" (Spring Framework 6 series) as soon as possible.

■Schedule

• 5.0.0-spring5　coming soon

• 5.0.0　　　　　beginning of July 2023
  *Schedule may change without prior notice.

Learn more about client libraries, see the following pages.
https://github.com/yahoojp-marketing/ads-display-api-java-lib
https://github.com/yahoojp-marketing/ads-search-api-java-lib

Comments

• For more information on each feature, refer to the release notes and references.
  Search Ads API v11 Release Note
  Display Ads API v11 Release Note
  Reference

• We will hold an online seminar to give an overview of v11 along with the release. See the following announcement for details.
  Yahoo! JAPAN Ads API Webinar information

Yahoo! JAPAN Ads API v9 Sunset

Yahoo! JAPAN Ads API v9 sunset is scheduled as follows.
　　Support end date: June 26, 2023 (Mon)
　　End of life date: October 23, 2023 (Mon)

Yahoo! JAPAN Ads API v8 sunset is scheduled as follows.
　　End of life date: June 26, 2023 (Mon)
　　*We have ended the user support for this version already.